Create Team

This endpoint allows the creation of a new team within the user's organization. It requires API key and email for authentication and accepts team details in a JSON request body.

Run in Postman

---

API Endpoint

api/v3/provisioning/user-team/team?apikey=<API_KEY>&email=<EMAIL>

Request Syntax

POST /api/v3/provisioning/user-team/team?apikey=<API_KEY>&email=<EMAIL>

Request Body

{
    "teamName": "sales",
    "supervisorId": "a4823dg4-d130-2412-9a82-e4c00f6f1427",
    "description": "sales team"
}

---

• Content-Type:
  • application/x-www-form-urlencoded (form-data)
• Parameters:
  • email: Caller’s EMAIL
  • apikey: API KEY

---

Properties

Placeholder	Type	Required	Description
teamName	string	Yes	Name of the team to be created
supervisorId	string	Yes	ID of the team’s supervisor
description	string	No	Optional description of the team

---

Example

Sample Request

curl --location 'https://alb-backend.msgkart.com/api/v3/provisioning/user-team/team?apikey=<API KEY>&email=<EMAIL ID>' \
--header 'Content-Type: application/json' \
--data '{
    "teamName": "sales",
    "supervisorId": "a4853df4-d170-4662-9a82-e4c00f6f8827",
    "description": "sales team"
}'

Response

• HTTP Status Code: 200 OK (successful), 4xx/5xx (error)
• Response Body: JSON object containing user status details.

---

Error Handling

• Invalid credentials: 401 Unauthorized
• Missing/invalid parameters: 400 Bad Request
• Internal server error: 500 Internal Server Error

Run in Postman